.TH SXACL-USERADD "1" "September 2014" "sxacl @VERSION@" "Skylable SX Manual"
.SH NAME
sxacl-useradd \- create a new user
.SH SYNOPSIS
.B sxacl useradd
\fR[\fI\,OPTIONS\/\fR] \fI\,<username> sx://\/\fR[\fI\,profile@\/\fR]\fI\,cluster\/\fR
.SH DESCRIPTION
\fBsxacl useradd\fR adds a new user to a Skylable SX cluster. By default, a regular user will be created. Only cluster administrators can create new users.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help and exit
.TP
\fB\-\-full\-help\fR
Print help, including hidden options, and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit
.TP
\fB\-t\fR, \fB\-\-role\fR=\fI\,TYPE\/\fR
User type. Accepted values are "admin" and "normal" (default).
.TP
\fB\-d\fR, \fB\-\-description\fR=\fI\,STRING\/\fR
Set the optional description of this user.
.TP
\fB\-q\fR, \fB\-\-quota\fR=\fI\,SIZE\/\fR
Set total quota for all volumes owned by this user (allows K,M,G,T suffixes). The user will not be able to store more data than this limit across all of the volumes it owns.
.TP
\fB\-a\fR, \fB\-\-auth\-file\fR=\fI\,FILE\/\fR
Store authentication key in a given file (instead of printing it).
.TP
\fB\-g\fR, \fB\-\-generate\-key\fR
Automatically generate a new key based on a random data instead of a password.
.TP
\fB\-b\fR, \fB\-\-batch\-mode\fR
Disable additional information and only print the automatically generated authentication key. 
.TP
\fB\-\-force\-key\fR=\fI\,KEY\/\fR
By default, the authentication key is automatically generated for the new user. With this option one can force the use of an old key (obtained with \fBsxacl\-usergetkey\fR(1)), when recreating the user on a new or another cluster. Only a key that was previously generated for the same username will be accepted.
.TP
\fB\-c\fR, \fB\-\-config\-dir\fR=\fI\,PATH\/\fR
Path to the SX configuration directory (default: ~/.sx)
.TP
\fB\-D\fR, \fB\-\-debug\fR
Enable debug messages.
.SH "EXAMPLES"
To add the user 'joe' to the cluster run:
.br
\fB    sxacl useradd joe sx://admin@cluster\fP
.br
.SH SEE ALSO
\fBsxacl-usermod\fR(1), \fBsxacl-usernewkey\fR(1), \fBsxacl-usergetkey\fR(1), \fBsxacl-userlist\fR(1), \fBsxacl-userdel\fR(1), \fBsxinit\fR(1)
